home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / dmenu1.zip / DOUGMENU.DOC < prev    next >
Text File  |  1991-10-15  |  9KB  |  239 lines
  1.               DougMenu v1.0 released October 15, 1991
  2.                                     (c) Copyright 1991
  3.  
  4. Features:
  5.     Virtually no memory overhead - Uses Batch files
  6.     Display up to 10 menu windows at one time.
  7.     10 definable color palettes
  8.     Cascade/Shadow display options
  9.     Built-in screen saver/ timed function execution
  10.     Programmable Function Keys
  11.     Supports most graphics cards: MDA, Hercules, CGA, EGA, MCGA, VGA, SVGA
  12.     Supports most text screens: 40, 80, 132 column
  13.     Mouse Support
  14.     Controlled exit feature
  15.     Can display an ascii file for a background
  16.  
  17.      
  18. -----------------------------------------------------------------------------
  19. Setting up DougMenu
  20.  
  21. DougMenu Requires the use of 2 files:
  22.   DOUGMENU.EXE and DMENU.BAT
  23.  
  24. When dougmenu is run, it will create a small temporary
  25. batch file called temp.bat.
  26.  
  27.  
  28. CONFIGURING DOUG MENU:
  29.  
  30.    To configure DougMenu, two lines need to be edited in DMENU.BAT.
  31.  
  32. Listing of DMENU.BAT:
  33.  
  34.     @echo off
  35. *   set t=C:\TEMP.FIL         
  36.  
  37.     :loop
  38. **  C:\MENU\DOUGMENU.EXE %1  
  39.     if errorlevel = 2 %t%
  40.     if errorlevel = 1 goto quit 
  41.     call %t%
  42.     goto loop
  43.  
  44.     :quit
  45.     set t=
  46.  
  47. *   -- This line should include the path of where you want the temporary 
  48. batch files to be stored.  A file name must appear after the path, and the
  49. name should end ".fil".  If you want to put the temporary files on a 
  50. networked drive, I recommend putting the connection number into an environment 
  51. variable, and using this variable to name the batch file.  This way,
  52. more than one person will be able to use DougMenu a once.  Still,
  53. logging out can be difficult it the temporary files are on a networked
  54. drive.
  55. **  -- This line should be set to the location of DOUGMENU.EXE on your 
  56. hard drive or networked drive.
  57.  
  58. Keep in mind that this is only a batch file, and can be edited into many 
  59. different working configurations.  Feel free to add anything to it which will
  60. help your system.  I don't take responsibility, though.
  61.  
  62. ________________________________________________________________________
  63.  
  64. STARTING DOUGMENU
  65.  
  66.      After DougMenu is configured for your system, to start the menu
  67. system, type:
  68.  
  69.     DMENU  DRIVE:\PATH\PATH\MENUSCRIPT
  70.  
  71. where the parameter after DMENU is the path and the name of the menu script.
  72. If DougMenu cannot find your menu script as specified, it will add ".MNU"
  73. to the end of the file name and look for that file.
  74.  
  75. ________________________________________________________________________
  76.  
  77. WRITING MENUSCRIPTS:
  78.  
  79.  
  80. Differences Between DougMenu and Novell Menu:
  81.  
  82. DougMenu reads menu scripts that are very similar to novell menu scripts.  
  83.  
  84. The only incompatibility is with the string input functions.
  85. Putting @1"Query Title" in a batch file will no longer query for input.
  86. This is done with the #ask command now.
  87.  
  88. DougMenu does not automatically sort the menus in alphabetical order.
  89.  
  90. Several more smaller changes.
  91.  
  92.  
  93. GUIDE TO MENUSCRIPTS:
  94.  
  95. Key to Variables:
  96.  
  97. XX,YY   X and Y coordinates; a 255 value means to place in the center of the
  98.         screen.
  99. PP      A palette between 0-9; 8&9 are the B&W palettes.
  100.  
  101. BG,FG   background and foreground colors
  102. CC      A color value between 0-15
  103.  
  104.         0   -   black             8   -   dark grey
  105.         1   -   blue              9   -   lt. blue
  106.         2   -   green             10  -   lt. green
  107.         3   -   cyan              11  -   lt. cyan
  108.         4   -   red               12  -   lt. red
  109.         5   -   magenta           13  -   lt. magenta
  110.         6   -   brown             14  -   Yellow
  111.         7   -   lt.grey           15  -   White
  112.  
  113.  
  114. Descriptions of Commands:
  115. (see sample.mnu for examples)
  116.  
  117. ;A Meaningless Comment
  118.     semicolons are for comments.
  119.     and line with a semicolon in the first column is a comment.
  120.  
  121. #include = filename
  122.     includes the text from the file "filename.mnu" at this point
  123.  
  124. #noexit
  125.     disables exiting the menu with the escape key.
  126.  
  127. #palette PP = CC,CC,CC,CC,CC,CC,CC
  128.     redefine palette PP with a customized palette
  129.     with the colors ordered as such:
  130.       Menu  Text  Title  Border  Highlighted  Selected  Selected 
  131.       BG  , FG  , FG   , FG    , Border FG  , Item BG , Item FG
  132.     This has no effect on computers with B&W monitors.
  133.  
  134. #shadow  [= BG,FG]
  135.     Turn on shadow and set the background and foreground colors.
  136.     If the colors are left out, the default is a foreground of
  137.     8 (dark grey) and a background of 0(black).
  138.  
  139. #cascade [= XX,YY]
  140.     Turns on cascade, resets default placement to 10,4, and
  141.     sets cascade vector to 4,1 (unless otherwise declared). 
  142.  
  143. #default placement = XX,YY
  144.     Default placement of all menus.  This sets the position of the
  145.     upper left corner.  Values of 255 should be used if you want
  146.     centering.  The default placement is centered.
  147.  
  148. #default palette = PP
  149.     Default palette of all menus.  By default, this value is 0.
  150.     This has no effect on computers with B&W monitors.
  151. #header palette = PP                                          
  152.     Sets the palette of the header.  By default this value is 1.
  153.     This has no effect on computers with B&W monitors.
  154. #error palette = PP
  155.     Sets the palette of all error boxes.  By default this value is 2.
  156.     This has no effect on computers with B&W monitors.
  157. #message palette = PP
  158.     Default palette of display boxes.  By default this value is 3.
  159.     This has no effect on computers with B&W monitors.
  160.  
  161. #backdrop color = BG,FG
  162.     Sets the color of the backdrop.
  163. #backdrop char = XX
  164.     Set a screen char for the backdrop. e.g.  65 = 'A'
  165. #backdrop file = filename
  166.     Displays an ASCII file for the backdrop.
  167.     The file pillars.ans has been included as a sample.
  168.     Ansi.sys must be a device for pillars.ans to display properly.
  169. #footer color = BG,FG
  170.     Set footer colors if using fn keys.
  171.  
  172. #timer = XXXX                
  173.   [stuff to do 
  174.   stuff to do] 
  175.  
  176.      Set timer.  If indented text lines follow, they will be executed as
  177.      any selectable menu item would be.  If no lines follow this declaration,
  178.      the screen will be blanked until a key is pressed.
  179.  
  180. #fXX = Title
  181.   stuff to do                           
  182.   stuff to do                           
  183.  
  184.      Define function key XX.  The title will be displayed in the footer.
  185.      The stuff to do will be executed as any selectable item in a menu
  186.      would be.
  187.  
  188.  
  189.  
  190. %Menu Title,XX,YY,PP 
  191.      Define menu "menu title" to be placed at XX,YY with palette PP.
  192.      To center, set xx,yy = 255. 
  193.  
  194. Selectable Item
  195.   batch file text                       Makes a batch file out of this stuff
  196.   batch file text                        and runs it
  197.   batch file text
  198.  
  199. Open a Stupid Menu                      Opens a menu titled 'stupid menu'.
  200.   %Stupid Menu
  201.  
  202. Dummy Divider                           If an item has no text, it is displayed
  203.                                          as a divider
  204.  
  205. Dumb Display Box                        Display text box at XX,YY using PP
  206.  #display,XX,YY,PP                       Set xx,yy = 255 to center the box.
  207.  stuff to display                   
  208.  stuff to display
  209.    
  210. Dummy Item                              Define a variable named "VARIABLE"
  211.  #ask VARIABLE,MESSAGE,XX,YY,PP          opens query menu titled "MESSAGE"
  212.   "sdfsdf" = sdfsdf                      at XX,YY using palette PP 
  213.   "sdfsdf" = sdfsdf                     Possible values are in quotes.
  214.  batch file text
  215.  batch fi%VARIABLE%le text              It is inserted into text like this.
  216.  batch file text
  217.  
  218. Dummy Item  2                            Define a variable named "VARIABLE"
  219.  #ask VARIABLE,MESSAGE,XX,YY,PP           opens string box titled "MESSAGE"
  220.  batch file text                          at XX,YY using palette PP 
  221.  batch fi%VARIABLE%le text               It is inserted into text like this.
  222.  batch file text
  223.  
  224. Other Dummy Item
  225.  batch file text
  226.  batch file text
  227.  batch file text
  228.  #exit                                   
  229.  
  230.     Exits the menu system after batch file made with batch file text has been 
  231.     executed.  It the temporary batch files are placed on a network drive,
  232.     it may cause trouble if you try and logout of login to another server
  233.     durring the batch text.  To be safe, place all the temporary batch files
  234.     on local drives.  Besides, you won't bog down the server or the network 
  235.     that way with needless traffic. 
  236.  
  237.  
  238.  
  239.